Troubleshooting DITA issues

Occasionally there might be issues with the source documents you are using. Below is a list linking to the wiki solutions website that will help you troubleshoot each one:

Issue

Solution

If you are having issues with whitespace when authoring with FrameMaker using DITA

White space in FrameMaker

If you are having issues with cross references when authoring with FrameMaker using DITA. In particular, if you are using the fm-xref element, generated output will not properly update the generated numbering. There is a solution to fix this behavior in FrameMaker.

DITA Cross References in FrameMaker

If you are receiving a Cannot Duplicate Document

Cannot duplicate document error message

If you are having issues outputting cross references from DITA

Cross Reference to same topic not working

If you are having issues using a custom DTD

DTD Issues

If you are using an older or newer version of the OTK

Different versions of the OTK

If you are trying to use conditional text

DITA conditions

If you are trying to localize figure/table paragraphs

Localization of the word "table" or "figure"

If you are getting a Java error when generating

Java Error

If you are trying to put a list in a table

List in a Table

If you are getting a Resample WIFerror upon generation

ResampleWIF Pipeline Error Blocks Generation of Output

If your elements are not being populated in the style designer

DITA styles are not being read in the Style Designer

If your Overview topics are showing up on the same level as their children

DITA Overview Topics Showing on Same Level as Children Topics

Last modified date: 08/12/2026